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About this guide 



This guide provides information about: 

• M aking the HP Storage Essentials menu accessible from HP SIM . 
■ Enabling H P SIM to receive events from HP Storage Essentials. 

Intended audience 

This guide is intended for: 

• N etwork Engineers 

• Administrators 

• Any one that needs to monitor and/ or manage their file servers 

Prerequisites 

Prerequisites for using this product include: 

• N etworking 

• Storage Area N etworks (SAN s) 

• The Common Information M odel (CIM ) 

Related documentation 

• O nline help for H P Storage Essentials 4.0 
HP Storage Essentials 4.0 Installation Guide 

• HP Storage Essentials 4.0 User Guide 

1 HP Storage Essentials 4.0 Application G uide 
HP Storage Essentials 4.0 CU Guide 
HP Storage Essentials 4.0 for File Servers G uide 

These and other HP documents can be found on the HP web site: htt p:/ / www.hp.com/ support/ 
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Document conventions and symbols 



Table 1 Document conventions 



Convention 


Element 


M edium blue text: Figure 1 


Cross-reference links and e-mail addresses 


Medium blue, underlined text 

(httrW / www hn mm) 

\ 1 1 VAmfJ if / VV VV VV . 1 1 |J 1 \_ U 1 i 1 / 


W eb site addresses 


Bold font 

LJ \J 1 VJ 1 U 1 1 L 


• Kpv na mps 

• Text typed into a GUI element such as into a box 

• GUI elements that are clicked or selected, such as menu and 
list items, buttons, and check boxes 


Italics font 


Text emphasis 


Monospace font 


File and directory names 

• System output 

• Code 

• Tpxttvnpd atthp rnmmand-linp 


Monospace , italic font 


• Code variables 

• Command-line variables 


Monospace, bold font 


Emphasis of file and directory names, system output code, and 
text typed atthe command line 



A CAUTION : Indicates that failure to follow directions could result in damage to equipment or data. 



O* 1 IMPORTANT: Provides clarifying information or specific instructions. 



if NOTE: Provides additional information. 
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HP technical support 

Telephone numbers for worldwide technical support are listed on the HP support web site: 
http :/ / www.hp.com/ support/ . 

Collect the following information before calling: 

• Technical support registration number (if applicable) 

• Product serial numbers 

s Product model names and numbers 
» Applicable error messages 

• 0 perating system type and revision level 

• Detailed, specific questions 

For continuous quality improvement calls may be recorded or monitored. 

HP strongly recommends that customers sign up online using the Subscriber's choice web site at 

http:/ / www.hp.com/ go/ e-updates . 

• Subscribing to this service provides you with e-mail updates on the latest product enhancements, 
newest versions of drivers, and firmware documentation updates as well as instant access to 
numerous other product resources. 

• After signing up, you can quickly locate your products by selecting Business support and then 
Storage under Product Category. 

HP-authorized reseller 

For the name of your nearest HP-authorized reseller: 

• In the United States, call 1-800-345-1518. 

Elsewhere, visit the H P web site: http:/ / www.hp.com . Then click Contact HP to find locations 
and telephone numbers. 

Helpful web sites 

For third-party product information, see the following HP web sites: 

• http:/ / www.hp.com 

• http:/ / www.hp.com/ go/ storage 

• http:/ / www.hp.com/ support/ 
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1 Setting Up HP Storage Essentials with HP Systems 
Insight Manager (HP SIM) 

HP Storage Essentials is a versatile, comprehensive software package thateasily plugs into HP SIM , 
thus expanding the features of H P SIM . Integration consists of: 

• Tools to launch to HP Storage Essentials from the HP SIM menu 

• H P Storage Essentials events sent to H P SIM 

This document assumes you have already installed H P Storage Essentials. If you want to use H P 
Storage Essentials with HP SIM , you must configure H P SIM and Storage Essentials as described in 
the following topics so thatStorage Essentials can work seamlessly within HP SIM : 

• Installing the HP Storage Essentials Tools into HPSIM , page 11 

• How to Receive Events from HP Storage Essentials, page 15 
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Installing the HP Storage Essentials Tools into HPSIM 



This chapter describes the following: 

• "Step 1 - M odifying the Tool Definition File" on page 11 

• "Step 2 -Adding the HP SE Toolbox" on page 11 

• "Step 3 - Registering HP Storage Essentials tools" on page 11 

• "Step 4 - Accessing HP Storage Essentials" on page 12 

• "Removing Access to Storage Essentials from HPSIM" on page 13 

Step 1 - M odifying the Tool Definition File 

HP Storage Essentials is plugged into the HP SIM Tools menu through the HP Storage Essentials Tool 
Definition XM L (shown in Appendix A). 

1. Copy the text in Appendix A and paste it in a text editor. 

2. W ithin the editor, alter the line that contains the text HPSE_HO ST such that H PSE_HO ST will 
reflect the DNS name of the HP Storage Essentials management server. 

For example, if the name of the host running Storage Essentials is M YHO ST, you would replace 
HPSE_HOST with M YHO ST, as shown in the following example: 

<main-url >http : / /MYHOST/ servlet . html?page=Home</main-url > 

This URL is accessed when the user clicks its corresponding menu option. 

3. W hen you are done with modifying the file, save the file in a directory of your choosing (such as 
"c:\ ") with the following name: H PSIM _SE_integ ration. xml 

Step 2 - Adding the HP SE Toolbox 

Create a toolbox in HPSIM that will contain the tools that will be added in step 3. 

1. 0 pen a command prompt window and go to the following directory: 

\Program Files\HP\Systems Insight Manager 

2. Enter the following at the command prompt: 

mxtoolbox -a "HP SE Tools" -d "HP Storage Essentials Toolbox" 

Step 3 - Registering HP Storage Essentials tools 

To make HP SIM aware of your changes to its menus: 

1. 0 pen a command prompt window and go to the following directory: 

\Program Files\HP\Systems Insight Manager 

2. Enter the following at the command prompt: 

mxtool -a -f c:\HPSIM_SE_integration.xml 

where c:\ is the location of the H PSIM _SE_integration.xml file 

3. Log out and then back into HP SIM . You do not need to restart HP SIM . 
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Step 4 - Accessing HP Storage Essentials 

To access H P Storage Essentials from H P SIM : 

1. You should be already logged into HP SIM (see the previous section). If you are not already 
logged into Insight M anager, do so now. 

2. Select Tools > Integrated Consoles > HP Storage Essentials. 



| Tools 


Deploy Configure Diaynose Reports Logs Optic 


System Information ► 






1 Integrated Consoles 


a 


HP BladeSystem... 




Custom Commands ► 


HP Storage Essentials... 




Webrnin,,, 



Figure 1 Accessing Storage Essentials from HP SIM 

3. You are then launched to the login page for HP Storage Essentials (or home page once logged 
in). 

4. You can quickly determine the version of HP Storage Essentials without leaving HP SIM by 
selecting Help > About HP Storage Insight Manager, as shown in the following figure: 



Help 

For HP Systems Insight Manager 

Table of Contents 

Index 

For This Page 

HP Systems Insight Manager on hp.com 
HP Storage Essentials on hp.com 
HP Forums 

HP Plug-in Applications 



About HP Systems Insight Manager 



Figure 2 Accessing information about the version of HP Storage Essentials 

The version number for H P Storage Essentials is shown in the Plug-in Applications table. 

5, You can visit the HP Storage Essentials website by selecting 
Help > HP Storage Essentials on hp.com. See Figure 2. 
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Removing Access to Storage Essentials from HP SIM 

To unregister the Storage Essentials tools from the HP SIM menu: 

1. 0 pen a command prompt window and go to the following directory: 

\Program Files\HP\Systems Insight Manager 

2. Enter the following at the command prompt: 

mxtool -r -f c:\HPSIM_SE_integration.xml 

where c:\ is the location of the H PSIM _SE_integration.xml file 

3. Remove the HP SE Toolbox. 

mxtoolbox -r "HP SE Tools" 

4. Log out and then back into H P SIM . You do not need to restart HP SIM . 

5. 0 nee these tools are unregistered, they do not appear in the menu structure and the XM Lfile 
can be altered or removed from the system. 
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How to Receive Events from HP Storage Essentials 

This chapter describes the following: 

"Step 1 Compile and register the H P Storage Essentials M IB" on page 15 
"Step 2 - Modifying and Registering the Event List Q uery" on page 15 
"Step 3 - Discover the Server Running HP Storage Essentials" on page 16 
"Step 4 - Configure HP Storage Essentials to send SN M P traps to HP SIM " on page 16 
"Step 5 - View HP Storage Essentials Events in HP SIM " on page 17 
"Disabling the Feature for Receiving Events from HP Storage Essentials" on page 17 

: you want HP SIM to receive events from HP Storage Essentials, you must: 

Compile and register the HP Storage Essentials M IB in HP SIM . 
Create an HP Storage Essentials event list in HP SIM 
Configure HP Storage Essentials to send its traps to HP SIM . 

Step 1 Compile and register the HP Storage Essentials M IB 

1. Insert the CIM Extensions C D-RO M from HP Storage Essentials into the C D-RO M drive of the 
server running HP SIM . 

2. Go to the Tools directory on the CIM Extensions C D-RO M . 

3. Copy the HPSE-Traps.mib file in the Tools directory to the following directory on the server 
running HP SIM : 

\Program Files\HP\System Insight Manager\mibs 

4. To compile the HPSE-Traps.mib file, open a command prompt window and go to the 
\Program Files\HP\Systems Insight Manager\mibs directory. Then, enter the 
following: 

mcompile HPSE-Traps.mib 

The file, HPSE-Traps.cfg, is created. 

5. To register the M IB for HP Storage Essentials, run the following command atthe command 
prompt: 

mxmib - a HPSE-Traps.cfg 

Step 2 - Modifying and Registering the Event List Q uery 

HP Storage Essentials Event List is created using the HP Storage Essentials Q uery XM L (shown in 
Appendix B). 

1. Copy the text in Appendix B and paste it in a text editor. 

2. W ithin the editor, alter the two lines that contain the text H PSIM _HO ST such that HPSIM _HO ST 
will reflect the DN S name of the H P SIM management server. 

For example, if the name of the host running HP SIM is MYHOST, you would replace 
H PSIM _HO ST with MYHOST, as shown in the following example: 

owner= "MYHOST\mxadmin" 
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3. W hen you are done with modifying the file, save the file in a directory of your choosing (such as 
"c:\ " ) with the following name: HPSIM_EventUstxml 

4. To make HP SIM aware of this new event list: 

a. 0 pen a command prompt window and go to the following directory: 

\Program Files\HP\Systems Insight Manager 

b. Enter the following at the command prompt: 

mxquery -a -f c:\HPSIM_EventList.xml 

where c:\ is the location of the HPSIM _EventUstxml file 

c. Log out and then back into HP SIM . You do not need to restart HP SIM . 

3 - Discover the Server Running HP Storage Essentials 

To make HP SIM aware of the server running HP Storage Essentials, run a manual discovery as 
described in the steps in this section. 



IM PORTANT: If HP Storage Essentials is running on a dual-homed server, provide the IP address 
that H P SIM can use to contact the server, most likely the primary IP address. 

1. Access HP SIM. 

a. Enter the following in a W eb browser: 

https : //host_name : 50000 

where host_name is the name of the server running Insight M anager. 

b. If you are asked about a security certificate, click Yes. 

c. If you do not have the Java plug-in, you are asked to install it 

d. Type a user name for accessing HP SIM in the User Name field. 

e. Type a password for accessing HP SIM in the Password field. 

f. If applicable, type a domain in the Domain field. 

g. Click Secure Login. 

2. Select Options > Discovery > Manual Discovery. 

3. Select one of the following: 

• System N ame - Provide the system name of the server running H P Storage Essentials. 

• IP Address - Provide the IP address of the server running HP Storage Essentials. 

4. Click Add System. 

HP SIM discovers the server running HP Storage Essentials. 

4 - Configure HP Storage Essentia Is to send SN M P traps to HP 

L. Log onto H P Storage Essentials. 

2. Select Configuration > Traps. 

3. Select Enable Trap Generation. 
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4. Type the following for the community string: public 

5. Click Save. 

6. Type the IP address of the server running H P SIM . 

7. Click Add. 

8. Log into H P SIM and discover the server running HP Storage Essentials. You will then start seeing 
events from HP Storage Essentials in H P SIM . 

Step 5 - View HP Storage Essentials Events in HP SIM 

To view only events from HP Storage Essentials, click All Storage Essentials Events under Event Lists 
> Storage Essentials in the System Lists pane in HP SIM , as shown in the following figure. 



Customize 



System Lists 

© System Lists 

O Event Lists 
© Events by Severity 
O Login Events 
O Storage Essentials 



I 



Figure 3 Accessing Events from Storage Essentials in HP SIM 

Disabling the Feature for Receiving Events from HP Storage 
Essentials 

You can disable HP SIM so that it no longer receives events from HP Storage Essentials, as 
described in the following steps: 

1. 0 pen a command prompt window and go to the following directory: 

\Program Files\HP\Systems Insight Manager 

2. To remove the event list for H P SIM , enter the following at the command prompt: 

mxquery -r -f c:\HPSIM_EventList.xml 

where c:\ is the location of the H PSIM _EventListxml file 

0 nee the mxquery command is entered, the event list no longer displays Storage Essentials. The 
HPsiM_EventList .xmi file can be altered or removed from the system. 

3. To make H P SIM no longer aware of the M IB for Storage Essentials, enter the following at the 
command prompt 

mxmib -d HPSE-Traps .mib 

4. To remove the HPSE-Traps .mib file, go to the \Program Files\HP\Systems Insight 

Manager\mibs directory and delete the file. 

5. Log out and then back into H P SIM . You do not need to restart H P SIM . 
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6. Disable the sending of traps from HP Storage Essentials by removing the IP address of the 
server running HP SIM that was added in Step 4 - Configure HP Storage Essentials to send 
SNMP traps to HP SIM, page 16. 
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A Code for the H PSIM _SE_integration.xml File 



<?xml version= 



l.O" encoding="UTF-8" ?> 



<!-- 



- - > 



<!-- 2005 Hewlett-Packard Development Company, L.P., All Rights Reserved. 



<tool-list> 

<web-launch-tool name="HP Storage Essentials" revision= "4 . 0 " > 
<category>Local Tools</category> 
<description> 

Manage storage resources with HP Storage Essentials 
</description> 
<toolbox toolbox-name="HP SE Tools" /> 
<web-block accepts-targets="f alse" > 

<main-url>http : / /HPSE_HOST/ servlet . html?page=Home</main-url > 
</web-block> 

<attribute name= "menu-path" >Tools | Integrated Consoles</attribute> 
<attribute name= "product -name " >HP Storage Essentials</attribute> 
< at tribute name = "product -version" >4 . 0</attribute> 
<!-- Remove the next line for 'in frame' launch --> 
< at tribute name= " target- frame " >_blank< /attribute > 
< /web- launch- tool > 

<web-launch-tool name="HP Storage Essentials on hp.com" revision= "4 . 0 " > 
<description> 

Launch to the HP Storage Essentials product information page 
</description> 
<web-block accepts-targets="f alse" > 
<main-url> 

http : //hl8 0 06 . wwwl .hp . com/products/ storage/ sof tware/esuite/ index . html 
</main-url> 
< / web-block> 

<attribute name= "menu-path" >Help< / attribute> 
< at tribute name= "menu- sort -key" >3 6</ attribute > 
< at tribute name= " show- title " >false</ attribute > 
< at tribute name= " show-ellipsis " >false</ attribute> 
< at tribute name= "target - frame " >_blank</attribute> 
< /web- launch- tool > 

</tool-list> 



- - > 



<!-- 



- - > 
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20 Code for the HPSIM_SE_integration.xml File 



B 



Code for the HPSE EventListxml File 



<?xml version= 



1.0" encoding= "windows- 1252 " ? > 



<!-- 



- - > 



<!-- 2005 Hewlett-Packard Development Company, L.P., All Rights Reserved. 



<query- list> 

<category name= " Storage Essentials" type="EventViews" access= "public " 

owner="HPSIM_HOST\mxadmin" /> 
<query name="All Storage Essentials Events" 
type= " EventViews " 

category-name= " Storage Essentials " 
access= "public" 
owner="HPSIM_HOST\mxadmin" > 
<criteria name= " CriteriaByEventType " 
sense=" INCLUDE "> 

<value>HP Storage Essentials</value> 
< / criteria> 
</query> 
< / query- list > 



- - > 



<!-- 



- - > 
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